home *** CD-ROM | disk | FTP | other *** search
/ Compendium Deluxe 2 / LSD and 17bit Compendium Deluxe - Volume II.iso / a / asiutils / asi-am1.dms / asi-am1.adf / DOCS / d6 < prev   
Text File  |  1999-12-31  |  11KB  |  335 lines
  1. INTUITRACKER V1.1
  2.  
  3. Jan-Ivar Bruaroy
  4.  
  5. IntuiTracker V1.1 is a soundtrack module-player.
  6.  
  7. IntuiTracker is an attempt to bring the music-world of the popular
  8. Soundtracker/Noisetracker programs, to the common amiga-user.
  9.  
  10. It's purpose is to play music of your choice in a multitasking-
  11. friendly manner. This gives you the opportunity to listen to your
  12. favourite Amiga 8-bit-digital-stereo-music-trax while you do other
  13. things, like programming, writing, painting, downloading or whatever
  14. you do with your amiga. (No! you can't use IT with "Xenon II"!)
  15.  
  16. Sure, you could just turn on the CD or cassette player, I hear you
  17. argue. Ok, but haven't you ever been humming on a tune from a game
  18. or a demo, while doin' some coding ? No? (I have!)
  19.  
  20. With IntuiTracker you can have your own collections of songs on
  21. either disks or on your harddisk.
  22. (At present I have about 10 Mb of modules on my harddisk!)
  23.  
  24. Features:
  25. - Supports Soundtracker V2.0 - 2.5 and Noisetracker V1.0 - 1.1 modules.
  26. - Multitasking friendly.
  27. - Control panel for easy control of play.
  28. - Volume control
  29. - Graphic spectrum-equalizer display
  30. - Programmable sequence of play of selected modules.
  31. - Random play of selected modules.
  32. - Introduces new format for Composers to sign their work (*)
  33. - Leave a song playing, when exiting program.
  34.  
  35. (*) - musicians: read chapter 6!
  36.  
  37. 1. SHAREWARE:
  38.    ~~~~~~~~~~
  39. This program is released as shareware. This means that if you like
  40. this utility, you should express it by sending around $10
  41. to the the author (that's me).
  42. I will mail you updates of this program when available, (if you don't
  43. specify otherwise). I will charge for the disk only.
  44.  
  45. Jan-Ivar Bruarøy,
  46. Tiurstien 31a,
  47. 3190 Horten,
  48. NORWAY.
  49.  
  50. I can be reached on these norwegian BBS's:
  51.  
  52. Crusaders BBS:    (068) 1088
  53. MediaFoto BBS:    (02) 176056
  54.  
  55. 2. INSTRUCTIONS:
  56.    ~~~~~~~~~~~~~
  57. IntuiTracker V1.1 will play music produced by:
  58. Soundtracker V2.0 - V2.5 or Noisetracker 1.0 - 1.1 or compatibles.
  59. Songs must be saved (or ripped) as ´modules´ in order to be played.
  60.  
  61. (Nearly all songs on demos and most games are made on a
  62. Soundtracker program. There are several soundtrack module-rippers
  63. available that will extract these as modules for you.)
  64.  
  65. IntuiTracker can be started from either CLI or Workbench.
  66. Click on the IntuiTracker-window to access the menus.
  67.  
  68.  
  69. HOW DO I PLAY A SONG ?!
  70.  
  71. 1. Find a disk which you know has some soundtracker-modules on it.
  72.    (Any soundtracker disk or a music-collection disk that's not
  73.     crunched and not a NON-DOS disk should do.)
  74.  
  75. 2. Click on the IntuiTracker-window.
  76.    Choose the menu/menuitem:  Tracks/Choose Disc.
  77.  
  78. 3. Enter the name of the disk:directory where the module is located.
  79.    (Probably DF0:modules or just DF0:)
  80.  
  81. 4. After loading, examine the Tracks-menu. If a module-name has
  82.    appeared, select it. If no names appear, don't panic. Do this:
  83.  
  84. - Select the menu/menuitem:  Prefs/MOD.files ONLY 
  85. - Do step 2, 3 and 4 again.
  86.  
  87. (Explanation: IT assumes all module-names begin with: "MOD."
  88. When you do step 4, IT will treat ALL files
  89. as modules. BE CAREFUL; Trying to load a file
  90. that NOT an ST-module is generally not healthy! )
  91.  
  92. 5. The song should now be loaded and played.
  93.  
  94. 6. You can select PREFS/Equalizer and PREFS/Control Panel to get some action.
  95.  
  96.  
  97. 3. MENUS 
  98.  
  99. Menu: Control -
  100.  
  101. PLAY/PAUSE/STOP - Obvious.
  102.  
  103. EJECT - Removes song from memory. To play it again, it
  104. has to be reloaded.
  105.  
  106. PLAY NEXT - Loads and plays the next song on the menu.
  107. In PROGRAM MODE the next in sequence will be loaded.
  108.  
  109. If RANDOM PLAY is active, the song to be loaded
  110. will be a song on the menu chosen at random.
  111. With RANDOM PLAY in PROGRAM MODE the songs
  112. chosen at random is limited to the those
  113. which are programmed.
  114.  
  115. PLAY PREV - Loads and plays the previous song on the menu.
  116.  
  117. PROGRAM MODE - This command allows you to program IntuiTracker
  118. to play several songs in a certain order.
  119.  
  120. To program, select this menu-item.
  121. The text "Select tracks" should appear in the
  122. window.
  123.  
  124. - Enter the "Tracks"-menu.
  125. The first menu-item has now changed to:
  126. "END PROGRAMMING"
  127.  
  128. - Select the songs you wish to enter in the
  129. program, in the order you want them to be
  130. played. The menu-item's short-keys will indicate the
  131. order you have chosen.
  132.  
  133. (HINT: You can multi-select songs by pressing
  134. the left button and drag the mouse over several items)
  135.  
  136. - To remove an item, just select it again.
  137.  
  138. - When you're finished, select END PROGRAMMING,
  139. and the first song in the program will be loaded.
  140.  
  141. - Program is now running.
  142.  
  143. - To end program mode and go back to normal
  144. operation, select PROGRAM MODE again. (checkmark will disappear.)
  145.  
  146.  
  147. REPEAT SONG - Option. Checkmark indicates ON.
  148.  
  149. When this option is on, a loaded song will play
  150. continuously until the user desides otherwise. This is the default.
  151.  
  152. When this option is off, the song will stop when
  153. the final position in the song has finished,
  154. or when a position-jump to an earlier position is found.
  155.  
  156. When in PROGRAM MODE, this option is called:
  157. REPEAT PRG, and it enables/disables repeat of
  158. the whole program sequence.
  159.  
  160. RANDOM PLAY - Option. Checkmark indicates ON.
  161.  
  162. Random play affects the sequence of play in PROGRAM MODE.
  163. It also affects the use of the PLAY NEXT
  164. and the PLAY PREVIOUS commands in both PROGRAM
  165. MODE and normal mode. The default is off.
  166.  
  167. ABOUT - Checkmark indicates ON.
  168. When a song is played, turning on this option
  169. will (when possible) display the name of the
  170. composer for that song. (musicians: see notes in chapter 6)
  171.  
  172. If no song is loaded, this option gives you
  173. some additional notes on IntuiTracker.
  174.  
  175. LEAVE SONG - Will quit IntuiTracker, but the last song will
  176. keep on playing. In technical terms:
  177. The program is unloaded, but the player-interrupt remains.
  178.  
  179. If REPEAT SONG is on when you exit this way,
  180. the song will go on forever.
  181. If REPEAT SONG is off, the interrupt will kill
  182. itself when the song finishes, and memory will be free'd.
  183.  
  184. Note that IT can intercept this playing interrupt again the next time 
  185. you start IT.
  186.  
  187. QUIT - Unloads everything.
  188.  
  189. Menu: Prefs -
  190.  
  191. The following menu-items are all options. Checkmarks indicate ON.
  192.  
  193.  
  194. VOLUME CONTROL  - \
  195. EQUALIZER       -  X Check it out!
  196. CONTROL PANEL   - /
  197.  
  198. NONE - Turns off the three above.
  199.  
  200. FILTER - Turns the amiga hardware low-pass filter (and the LED) on or off.
  201. This does not works on Amiga 1000. The default is off.
  202.  
  203. A soundtracker song has the option to turn the filter on or off by itself.
  204. This will by default override the IntuiTracker setting.
  205. Some ST-musicians tend to mis-use the filter
  206. by flashing the LED, with their soundtracks.
  207.  
  208. By selecting the FILTER OVERRIDE switch on
  209. IntuiTracker, the filter settings in each song
  210. will be ignored, and the IT setting is final.
  211.  
  212. DEPTH GADGET - Gives the IntuiTracker-window depth gadgets.
  213. Because of lack of space and cosmetic reasons, this defaults to off.
  214.  
  215. When depth gadgets are off, the window is pushed
  216. to the front when you active it.
  217.  
  218. MOD.files ONLY - IntuiTracker, as default, expects all module
  219. files to begin with the letters "MOD.".
  220. If they don't, they wont appear on the menu.
  221. Turning "MOD.files ONLY" off will make IT
  222. accept all filenames as valid module-files.
  223.  
  224. The Noisetracker versions and the earlier
  225. Soundtracker versions all defaults to writing
  226. the "MOD." prefix on all modules they save.
  227. Soundtracker V2.4 and V2.5 has regretably dropped this.
  228. I say regretably because a soundtrack-module
  229. as a result of it's crowded format, is hard to
  230. distinguish from other files.
  231.  
  232. Note that, although IntuiTracker checks the
  233. files being loaded, you should avoid trying
  234. to load any NON ST/NT-module files, as
  235. the checking routines aren't fail-safe.
  236.  
  237.  
  238. MUSIQUE NON-STOP - When IT loads a new song, by user command, or
  239. as a part of a program sequence, it will, if
  240. chip-memory allows it, load the new song without
  241. cutting off of the song being played.
  242. This gives you as much uninterrupted listening
  243. pleasure as possible.
  244. (In a program-sequence, this is done by
  245. pre-loading the following song, before the current has finished.)
  246.  
  247. With this method, however, IT needs to have both
  248. songs in memory at one time. This is very
  249. memory-intensive, and it may also fragment
  250. your memory if you use other memory-intensive programs at the same time.
  251.  
  252. Therefore; If memory is a concern, you use this
  253. option to turn off the non-stop loading technique. (The default is on.)
  254.  
  255.  
  256. 4. CONTROL PANEL:
  257.    ~~~~~~~~~~~~~~
  258. The control panel has the following set of gadgets:
  259.  
  260. +---+---+--------+--------+--------+--------+--------+-------+-------+
  261. | + | - |   |<   |   <<   |   |>   |   >>   |   >|   |   .   |   ^   |
  262. +---+---+--------+--------+--------+--------+--------+-------+-------+
  263.  
  264. |> - PLAY/PAUSE (*)
  265.  
  266. . - STOP (*)
  267.  
  268. ^ - EJECT (*)
  269.  
  270. >> / << - Forward / Rewind. Moves through positions in song.
  271.  
  272. >| - PLAY NEXT (*)
  273.  
  274. |< - PLAY PREVIOUS (*)
  275.  
  276. + / - - Changes the speed of play-back.
  277. A soundtracker-song may change it's speed
  278. during play. Since you may start a song from
  279. any position, the speed may not be set correctly.
  280. These gadgets are useful for correcting this.
  281.  
  282. Pressing PAUSE or STOP cancels your changes.
  283.  
  284. 5. GENERAL NOTES ON FORMAT:
  285.    ~~~~~~~~~~~~~~~~~~~~~~~~
  286. As mentioned earlier, IntuiTracker assumes all module files begin
  287. with the letters "MOD.". Although the "MOD.files ONLY" option will
  288. allow you to load ANY kind of file, I strongly suggest that when you
  289. make a collection directory of your modules that you rename your
  290. files appropriately.
  291.  
  292. If you have the ARP rename command installed in your system this can
  293. be done quite easily by entering your directory and typing:
  294.  
  295. rename * to mod.*
  296.  
  297. As a rule for future expansion, IT will also accept the following
  298. extension formats:    ".Snn"  and  ".Nnn"
  299.  
  300. These extensions indicate the soundtracker or noisetracker version
  301. used to create the module. The versions in the example are
  302. Soundtracker V2.5 and NoiseTracker V1.1 respectively.
  303.  
  304. PLEASE NOTE that these extensions have NO bearing on IT's treatment
  305. of the modules. The ".Snn" and ".Nnn" extensions are for future
  306. compatibility, or for your own reference only.
  307. This version of IntuiTracker handles all formats without distinction.
  308.  
  309. 7. WARNING!
  310.    ~~~~~~~~
  311. 1. Intuitracker has been carefully tested for bugs, and should under
  312. normal circumstances not crash your machine.
  313. (This is no guarrantee though. If this DOES happen, let me know!).
  314. Please note however that due to the memory-intensive nature of
  315. IT's operation, running a large music-piece on IT simultaniously
  316. with other programs, may cause OTHER programs to crash!
  317. Many Amiga programs (including the workbench!) may crash when
  318. it runs out of chip-memory.
  319.  
  320. You should therefore always keep an eye on your chip-memory,
  321. when using IntuiTracker.
  322. Ejecting a song after you are done with it frees up chip-memory,
  323. so does turning off the equalizer window, etc.
  324.  
  325. 2. FOR HARDDISK USERS, a system crash can be fatal if the system
  326. crashes while you are saving to your harddisk.
  327. IntuiTracker works absolutely fine with my harddisk and my system-
  328. configuration. All I am saying is, that until you get aquainted
  329. with IntuiTracker, take it easy. Make sure it works with your
  330. system. I hope you understand I can take no responsibility for
  331. any mis-haps. This product is delivered "as is".
  332.  
  333. Have this in mind when you use IntuiTracker. 
  334.  
  335.